Internal program's name	: ZBDBZ83
Long name		: Dragon Ball Z83, The sayan battle
Type of program		: Game
Type of game		: Battle
Size of the program	: 5361 bytes (English version)
Version			: 0.5
SHELL Required		: ASHELL V1.0 or SOS V2.0
Author			: Alex P.Soeiro
E-Mail			: kameha@voila.fr
Date of release		: February 2002
Project started	on	: December 1999


	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
	!!!							  !!!
	!!!  ALL RIGHTS RESERVED TO AKIRA TORIYAMA & BIRD STUDIO  !!!
	!!!							  !!!
	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


**************************************************************************************
*** Translation correction made by : Bear Civetz, E-mail : thewettoad@hotmail.com  ***
**************************************************************************************


!WARNING!

Before using this program, I strongly recommend you to make a BACKUP of your calculator. This program is released as is.
The responsability of the author may not be engaged due to a problem met with the use (correct or not) of the program.
Thanks for your attention.


Files joins	:	"DBZ83.83P"	 : TI-83 File (French version game)
			"DBZ33ENG.83P"	 : TI-83 File (English version game)
			"DBZ83V05ENG.txt": This file. It contains informations about the game.
			"DBZ83V05.txt"	 : The same file, in French!
			"DBZ83.ASM"	 : Source code of the game.


SUMMARY
-------

1. What is it ?
2. What do you need.
3. How does it work ?
	3.1. Scenario
	3.2. Keys for the menu screen
	3.3. Keys for the game
	3.4. Moves and attacks
	3.5. Defense
	3.6. Other useful keys while the game
4. Versions
5. Extras...
6. Source code

If you're in a hurry because you already know about the transfer PC<->TI, go on section 3 !

1. What is it ?
---------------

This is a freeware program for the TI-83 calculator, written in assembly. So it will work ONLY on this machine and NOT IN other one.
In fact, it's a battle game based upon the Dragon Ball Z caracters series.

2. What do you need.
--------------------

Well... A TI-83 calculator of course! And you will need also a link cable, the software to make the transfer possible, and "ASHELL" or "SOS" (they are SHELLS, and they allow the game to run). You will find them at:

	http://www.ticalc.org
	http://www.ti-83.fr.st	(French Site)

I think you know the first very well. The second is a french site, where you can find information about the TI-83. Just for your
french culture !!! ;)
There are more sites. However, each of them give links to more sites, like Dimension TI...


When you have these things, send "DBZ83ENG.83P" and the SHELL (if you don't already have it) to your calc.


3. How does it work ?
---------------------

Execute ASHELL (or SOS), then select "ZBDBZ83" (or "Dragon Ball Z83, The saiyan battle") and press [ENTER].

WARNING: Do NOT edit "DBZ83". if you make any modification, you may crash your calculator and lose your data !!
However, you would not be able to do this.

3.1. Scenario
-------------

You will fight the 4 other saiyans. When you lose a battle, you will be able to take a "Senzu" (senzu bean). You have 3 "Senzu". When there's none left, you lose the game. To take a "Senzu", press [ENTER]. DO NOT PRESS ANY OTHER KEY: It means you give up, and the game will return to the title screen.

3.2. Keys for the menu screen
-----------------------------

Choosing your character	: [UP] & [DOWN].
Confirm your choice	: [ENTER]
Quit the game		: [CLEAR]

3.3. Keys for the game
----------------------


Special --+		+-- Row	change	   Power up-+
	  |		|   		   	    |
	  V		V			    V
	+-------+   +-------+			 +-------+
	|  2nd  |   | MODE  |			 |   UP	 |
	+-------+   +-------+ 		+-------++-------++-------+
					| LEFT  |	  | RIGHT |
	+-------+   +-------+           +-------++-------++-------+
	| ALPHA |   |X,T,O,n|		   ^	 | DOWN  |    ^
	+-------+   +-------+		   |	 +-------+    |
	    ^		 ^		   |	    ^	      |
	    |		 |		   |--------|---------+
	Punch		Kick		   |		+-------+
				moves and special	| CLEAR |
				attacks			+-------+
							   ^
							   |
					Pause and quit  ---+
					the game (after confirmation)


3.4. Moves and attacks
----------------------

-------------------------------------------------------------------------------------
| Key(s)			| Action	| POWER		|Life your opp. lose|
-------------------------------------------------------------------------------------
|				|		|		|		    |
| [LEFT] / [RIGHT] / [MODE]	| MOVE your hero|     00	|	00	    |
|				|		|		|		    |
-------------------------------------------------------------------------------------
|				|		|		|		    |
|	[UP]			| Power up	|     +1	|	00	    |
|				|		|		|		    |
-------------------------------------------------------------------------------------
|				|		|		|		    |
| [ALPHA] / [X,T,O,n]		| Punch / kick	|     00	|   Depends	    |
|				|		|		|		    |
-------------------------------------------------------------------------------------
|				|		|		|		    |
| [LEFT],[RIGHT], Punch/Kick	| Slide Pch/Kick|   Depends	|   Depends	    |
|				|		|		|		    |
-------------------------------------------------------------------------------------
|				|		|		|		    |
|	[2nd]			| KI Blast 	| 	1	| Same as Punch	    |
|				|         	|		| 		    |
|				|		|		|		    |
-------------------------------------------------------------------------------------
|				|		|		|		    |
| [LEFT],[DOWN],[RIGHT],[2nd]	|Special KI move|   Depends	|   Depends	    |
|				|		|               |		    |
-------------------------------------------------------------------------------------

Legend :  / : You've got a choice, one or the other one!
	  , : Successively. i.e., For the special KI move (Kamehameha...), you will have to press Left, down, tight, 2nd.
	      Don't press 2 keys at the same time, it won't work. BUT, you can easily slide with your finger the arrow keys !
	  "Depends" means that if you give a punch with Son Goku, it won't hurt as much as Vegita's punch.


3.5. Defense
------------

It works on all attacks that the computer does:

[LEFT]	 : Protect yourself. You will lose some life; it depends how strong the computer is.
[MODE]   : Evade. you will lose 0 life.

NOTE: When the computer makes a special attack or a KI move, you have NO choice: you must defend yourself. You CAN'T make a counter-attack. 

3.6. Other useful keys while the game
-------------------------------------

During the game, [CLEAR] will pause the game. Then, if you hit a key, you will continue the game. If you press [ENTER], you will QUIT the game. In pause mode, you can adjust the contrast.( [2nd]+[UP]/[DOWN] ).

WARNING: Do not leave the calc, when the battle is running: The APD (Auto-Power Down) function is removed. So, the calc won't turn off automaticaly and you will use your batteries. On the other hand, you will lose the match ;).


4.Versions
----------

Here is the history of the released versions.
the + means an addition on the game
the * means a modification 
the - means that I've removed something!

V0.5:
-----

*manoeuvrability. It's more easier to make a special KI move.
*End of the game. There are...  I let you see!

Size of the program : 5361 (Fr), 5361 (En)

V0.4:
-----

+++ English version +++++++++++++++++++++++++++++++++++++++++++++
+ Yes! Now, there is 2 prog.: DBZ83.83P, french version, and 	+
+ 			      DBZ83ENG.83P, english version  	+
+ The difference is between the names and some dialog sentences +
+++ English version +++++++++++++++++++++++++++++++++++++++++++++

*Code reduction
*Declaration of variables. The STATVARS zone is used to memorize them.
*Name of one caracter: SON GOTEN! and not SON GOTHEN (I've bought the 42nd book !)

Size of the program: 5235(Fr), 5229 (En)

V0.3:
-----

*Code reduction by about 50% !!!!!
Now, ASHELLV1.0 from Bill Nagel is required: I've "squished" my prog.
*Display of the logo (now using LDIR instruction)
*Trunks' first attack name (I've found the right (french) ortograph!)
*Code reduction (and speed up): LD A,0 replaced by XOR A (thanks to Jrmie!)
*Code reduction (and speed up) of the sprite's routine.
*Code modification about routines' call -> size code reduction.
+Animation of the title at the begining of the game. (it's look like nice!).


size of the program: 5473 bytes.

V0.2:
-----

+computer's moves
+computer's attacks   : Punch
			Kick
			Slide Punch
			Slide Kick
			KI blast
+Computer's defense
+Computer's power control
+Computer's loss of power control
+Computer's loss of life control
+Computer's death control
+Hero's moves	      : Slide Punch
			Slide Kick
			Simple KI blast (with [2nd])
+Hero's defense
+Hero's loss of power control
+Hero's loss of life control
+Hero's death control
+Continues control
+End of the game (will change later)
*Data for the computer's moves

Size of the program: 11218 bytes

V0.1: (Demo Version, First released version)
-----
+Graphics
+Title screen
+Choice of the hero
+Hero's moves control
+Hero's attacks	      :	Punch
			Kick
			Special KI blast
+Hero's power control
+Data for the computer's moves

Size of the program: 6529 octets

Futures Versions: Code reduction, Moves control when the hero is on the
right of the computer.
End of the game more funny...

5. Extras
---------

Well, First, Thanks to all the authors that give source code's with their game's and also to Benot for his tutorial "ASM for TI83". It give to me a quick idea to program 2-3 things on the TI-83, even though I knew the Z80 since the fabulous AMSTRAD 6128 on wich I made some BASIC/ASM programs.


For now, THERE IS NO 2 PLAYERS VERSION: I HAVEN'T MADE IT !!!
I want to be understood: I want to completely finish the game before starting the 2 players version. When i have finished this game, I will be able to think about making the 2 players version on 1 or 2 calc, with the link cable. But, it is not expected for now (because of my studies).


I'd like to give a particular thanks to "NEO ROUTINES": I have "picked up" the random number generator. I used it for the computer's moves. THANKS.

Also one to Cameron McCormack for "Chaos assembler": It gave me the chance to write, read, debug, and squish my prog with only one tool!!

Try the emulator of Rusty Wagner. "Virtual TI" gave me the help I needed. Great!

Why DBZ83 ?
-----------

I won't be so long as in french! I will sum up. 

I've played DBZ games. But, there were no DBZ games on the AMSTRAD 6128 computer. So I decided to create it. It's one of my greatest game that I've made. There is music, animation, scenery and more (I'm writing it progressivly for the emulator, you can ask me to send you the file, i will be very pleased! The only problem is that it's in french).
But, when i wrote it i did not wanted to make the same game that I played. I've included a new feature: when your power grow, you become a sayian and more! (in my AMSTRAD version, there is also the fusion!). Concording to your state (sayian or not), your attacks and defend are more powerful or not. That's my special feature and the originality of my game!

So, DBZ83 is just the adaptation of my AMSTRAD game, and i even add another feature: the caracteristic of each character are differents (when you take Son Goku and you give a punch, you won't hurt our opponent as Vegita). However, I removed some stuff like sound and scenery. But, the graphism are the same! (I know, I don't know how to draw...)

Well, finally, in any way, you can give me all your comments, suggests, critics or "bravo" for this little game. (Except the graphics!!!). I remember my e-mail: kameha@voila.fr


6. Source code
--------------

I give the source code file. It has comment, but they are in french. All details are not commented, like optimizations. You can modify it, but only for your personnal purpose. If you want to make an adaptation for another calculator, there is no problem! Just indicate that your game is the adaptation of DBZ83.
However, you can pick up the 3 sprites routines. you can re-use them for your game, I don't mind. These routines are picked up from an other project I made. I hope, it will be helpful for beginners and that other programmers will find some routines they seek.


	Hoping you will spend a funny time with my game.

									By A.P.S.